home *** CD-ROM | disk | FTP | other *** search
/ ETO Development Tools 4 / ETO Development Tools 4.iso / Essentials / Developer Essentials May91 / Essential Utilities / MacsBug 6.2.1 / Read Me < prev   
Encoding:
Text File  |  1991-05-01  |  4.8 KB  |  139 lines  |  [TEXT/MPS ]
  1. =================================================
  2.  
  3. MacsBug 6.2    1/25/91    © Apple Computer, Inc. 1981-91
  4.  
  5. You should use the “Debugger Prefs” included with this MacsBug.
  6. It contains macros, templates, dcmds, and the C++ name unmangler.
  7. You may add your own resources to “Debugger Prefs”,
  8. or remove some to decrease memory usage.
  9.  
  10. =================================================
  11.  
  12. New features since 6.1
  13.  
  14. MacsBug 6.2 supports the Macintosh Plus and all newer
  15. Macintosh models. These are the Macintosh Plus, SE, II, IIx,
  16. IIcx, SE30, Portable, IIci, IIfx, Classic, IIsi and LC.
  17.  
  18. MacsBug 6.2 works reliably with all Apple monitors and all
  19. third-party monitors if their slot ROM and driver software
  20. have been designed according to the guidelines presented
  21. in Designing Cards and Drivers for the Macintosh II and
  22. Macintosh SE, with and without 32 bit QuickDraw.
  23.  
  24. MacsBug 6.2 runs under A/UX 2.0.
  25.  
  26. Typing Command-D instead of Command-; with an international
  27. keyboard accesses the symbol list.
  28.  
  29. If the selected symbol in the scrollable list contains a
  30. C++ or Object Pascal class name, then pressing the tab key
  31. qualifies the list by that name.
  32.  
  33. MacsBug 6.2 displays the name of the current application,
  34. the memory management scheme (24 bit/32 bit) currently used,
  35. and whether you are running and have access to virtual memory.
  36.  
  37. New options for the Find command allow you to specify the width
  38. of the pattern for which MacsBug searches. One of these options
  39. allows MacsBug to look for 24 bit pointers.
  40.  
  41. The heap dump display is more detailed and works with 24 bit
  42. and 32 bit heaps.
  43.  
  44. An extension to the GT command allows you to specify
  45. one or more MacsBug commands to be executed
  46. once the specified breakpoint is reached.
  47.  
  48. Beginning with MacsBug 6.1 (but not documented),
  49. the DebugStr trap was extended so that you could include
  50. one or more commands in the message string to DebugStr.
  51. After MacsBug is invoked by the DebugStr trap, in addition
  52. to displaying a message specified with DebugStr, MacsBug
  53. executes the command(s) included in the message for DebugStr.
  54. The syntax for the call is as follows:
  55.  
  56. DebugStr ("string [; cmd]")
  57.   string is the message to display.
  58.   cmd is a MacsBug command or macro.
  59.  
  60. Example:
  61.  
  62. DebugStr ("Checking the heap ;hc ;g")
  63.  
  64. This routine invokes MacsBug, display the message "Checking
  65. the Heap", does a heap check, and resumes execution of the
  66. program.
  67.  
  68. The printf dcmd included in “Debugger Prefs” allows you to
  69. produce formatted output.
  70.  
  71. =================================================
  72.  
  73. Changes after the 6.2 release notes went final
  74.  
  75. The 'mxbh' help resource now resides in the “MacsBug” file
  76. of MacsBug 6.2.
  77.  
  78. SC6, SC7, and HZ take optional parameters. More information on
  79. these parameters can be obtained from the help command.
  80.  
  81. The SC commands allow to crawl stacks anywhere in the memory.
  82. HZ knows about embedded, 24 bit, and 32 bit heaps.
  83. HX allows to switch to partially damaged heaps.
  84. HD knows a new Q option and displays an additional summary line.
  85.  
  86. HZ and HD display partially damaged blocks and heaps with ! or ?
  87. next to the address.
  88.  
  89. If an address is in a known resource but not in a known
  90. procedure then an artificial symbol may be displayed by MacsBug.
  91. E.g. 'CODE 0006 0C20 Pickers'+0262 indicates the address which
  92. is $262 bytes offset into CODE 6 resource, named "Pickers", of
  93. file $0C20.
  94.  
  95. =================================================
  96.  
  97. We know about some bugs :
  98.  
  99. If ATR is on and A0 points into hardware registers on some
  100. NuBus cards then reading the bytes which A0 points to may
  101. cause the card to perform erratically (e.g. video flickering,
  102. network malfunction).
  103. For now try to use ATT instead in such situations.
  104.  
  105. Sometimes MacsBug loses FPU status when an NMI interrupts
  106. two consecutive FPU instructions.
  107. If you encounter this use _DebugStr instead of hitting the NMI.
  108.  
  109. There are still problems with a few video cards and video
  110. drivers.
  111. For now if you have more than one screen try to run MacsBug
  112. on the other screen.
  113.  
  114. If you use a pre-release of System 7.0 and switch VM on then
  115. use common sense to avoid :
  116. - using the MacsBug Find command over NuBus card memory
  117. - searching for symbols in memory that is swapped to disk
  118.   (you may want to consider using the SX command)
  119.  
  120. ATHC sometimes reports an invalid heap if the Memory Manager
  121. calls _BlockMove while the heap zone free bytes are not yet
  122. adjusted.
  123. For now ignore these warnings or use ATHCA.
  124.  
  125. The source code provided for dcmds requires MPW 3.1 to build
  126. the dcmds. It currently does not build with MPW 3.2.
  127. This does not affect the execution of the dcmds included in
  128. the file “Debugger Prefs”.
  129.  
  130. =================================================
  131.  
  132. In addition to these specific changes,
  133. you should find MacsBug 6.2 easier to use.
  134.  
  135. Whenever possible its output has been made more articulate
  136. and its displays more intelligible.
  137.  
  138. Feedback is an important and appreciated contribution.
  139.